Skip to content

mdx: en ja section fragment 링크를 바로잡습니다#1024

Merged
jk-kim0 merged 1 commit into
mainfrom
jk/locale-fragment-links-20260707
Jul 7, 2026
Merged

mdx: en ja section fragment 링크를 바로잡습니다#1024
jk-kim0 merged 1 commit into
mainfrom
jk/locale-fragment-links-20260707

Conversation

@jk-kim0

@jk-kim0 jk-kim0 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

문제 현상

  • Confluence 동기화 후 영어/일본어 문서 일부 내부 링크가 한국어 section fragment를 유지해 대상 heading으로 이동하지 못했습니다.
  • 기존 동기화 PR #1023은 이미 merge되어, 링크 수정만 분리한 후속 PR로 작성합니다.

수정 내용

  • en/ja 내부 상대 링크의 fragment를 각 locale 문서의 실제 rendered heading id에 맞게 교체했습니다.
  • dac-general-configurations.mdx의 Access Control 회수 링크를 포함해, user manual, databases, Okta, SAC, WAC quickstart 관련 fragment 링크를 정리했습니다.
  • WAC quickstart 영문 링크 3개는 남아 있던 한국어 section label도 실제 영문 대상 section에 맞춰 함께 보정했습니다.

검증

  • node 스크립트로 en/ja 내부 fragment 링크 30개를 .next/server/app HTML id와 대조해 misses: [] 확인했습니다.
  • rg --pcre2로 percent-encoded 비ASCII 내부 링크 잔여 없음 확인했습니다.
  • git diff --check를 통과했습니다.
  • npm run build를 통과했습니다. 기존 Turbopack/NFT 경고와 sitemap 생성 단계의 ENOBUFS 경고는 있었지만 exit code는 0입니다.

영어와 일본어 문서의 내부 링크 fragment를 각 locale 대상 문서의 실제 heading id에 맞춥니다.

Constraint: 한국어 원문 fragment와 en/ja heading id가 locale별로 다릅니다.
Rejected: 한국어 percent-encoded fragment 유지 | en/ja 렌더링 heading id와 일치하지 않아 section jump가 동작하지 않습니다.
Confidence: high
Scope-risk: narrow
Directive: localized 문서의 section 링크는 대상 locale의 rendered heading id를 기준으로 검증합니다.
Tested: node 스크립트로 en/ja 내부 fragment 30개를 .next HTML id와 대조; rg --pcre2로 percent-encoded 비ASCII 내부 링크 잔여 없음 확인; git diff --check; npm run build
Not-tested: 브라우저 수동 클릭 검증
Generated-with: Codex
@vercel

vercel Bot commented Jul 7, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Jul 7, 2026 6:08am

Request Review

@jk-kim0 jk-kim0 merged commit 6297f98 into main Jul 7, 2026
5 checks passed
@jk-kim0 jk-kim0 deleted the jk/locale-fragment-links-20260707 branch July 7, 2026 07:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant